home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / admin.fmt / fsattach.man < prev    next >
Encoding:
Text File  |  1991-01-23  |  9.2 KB  |  267 lines
  1.  
  2.  
  3.  
  4. FSATTACH                  User Commands                  FSATTACH
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NNAAMMEE
  11.      fsattach - Check disks and export prefixes
  12.  
  13. SSYYNNOOPPSSIISS
  14.      ffssaattttaacchh [_o_p_t_i_o_n_s]
  15.  
  16. OOPPTTIIOONNSS
  17.      --mm _f_i_l_e        Read mount table from _f_i_l_e.
  18.  
  19.      --WW             Check disks, but do not write changes.
  20.  
  21.      --ff             Don't check disks (fastboot).
  22.  
  23.      --ss             Ignore group information found in mount table
  24.                     and run ffsscchheecckk sequentially.
  25.  
  26.      --vv             Have both ffssaattttaacchh and ffsscchheecckk   output  ver-
  27.                     bose information while running.
  28.  
  29.      --nn             Don't attach disks or export prefixes.
  30.  
  31.      --pp             Print out actions but don't execute them.
  32.  
  33.      --hheellpp          Print a summary of the  command-line  options
  34.                     and exit.
  35.  
  36.      --dd _d_e_v_i_c_e_D_i_r_e_c_t_o_r_y
  37.                     Specifies the directory containing the device
  38.                     files.  The default is "/dev".
  39.  
  40.      --kk             Produce debugging output.
  41.  
  42.      --ii _s_p_r_i_t_e_I_D    Causes prefixes that this machine will export
  43.                     to  be  preloaded into the prefix table. This
  44.                     prevents the machine  from  broadcasting  for
  45.                     its  own  prefixes  while the disks are being
  46.                     checked.
  47.  
  48.      --jj _m_a_x_J_o_b_s     The default behavior is for ffssaattttaacchh  to  run
  49.                     as  many  ffsscchheecckk jobs in parallel as it can.
  50.                     The parallelism is limited by  the  _g_r_o_u_p  of
  51.                     each device (see below), and the --jj flag.  If
  52.                     this  flag  is  used  then  at  most  _m_a_x_J_o_b_s
  53.                     _f_s_c_h_e_c_ks will be run at a time.
  54.  
  55.      --ffsscchheecckk _f_s_c_h_e_c_k_P_r_o_g
  56.                     Use this to specify  an  alternative  fscheck
  57.                     program, i.e. when testing a new fscheck.
  58.  
  59.      --cc 15          Conditionally check the disks.  If the  disks
  60.  
  61.  
  62.  
  63. Sprite v.1.0       Printed:  January 23, 1991                   1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. FSATTACH                  User Commands                  FSATTACH
  71.  
  72.  
  73.  
  74.                     were  just  checked by _f_s_c_h_e_c_k and we are now
  75.                     rebooting, then we don't have to check again.
  76.                     If  the  --cc  flag  is  present then the disks
  77.                     won't be rechecked.
  78.  
  79. _________________________________________________________________
  80.  
  81.  
  82. DDEESSCCRRIIPPTTIIOONN
  83.      FFssaattttaacchh is used during system boot to check the  disks  for
  84.      inconsistencies  and to export prefixes.  The input to ffssaatt--
  85.      ttaacchh is a mount table, usually in  /_h_o_s_t_s/$_H_O_S_T/_m_o_u_n_t.   The
  86.      location  of  the mount table is specified by the --mm option.
  87.      FFssaattttaacchh uses the pass information in  the  mount  table  to
  88.      create  child processes that check the disk partitions using
  89.      ffsscchheecckk.  The output from ffsscchheecckk is appended to a file with
  90.      the  same  name  as  the  device  and the suffix ".fsc".  If
  91.      ffsscchheecckk completes normally, then the filesystem  is  mounted
  92.      and its prefix exported.
  93.  
  94. MMOOUUNNTT TTAABBLLEE
  95.      The mount table contains information on checking  the  disks
  96.      and  on exporting prefixes.  Each line in the table consists
  97.      of a command and its arguments. Blank lines and  lines  that
  98.      begin  with  '#' are ignored.  The AAttttaacchh command is used to
  99.      check a disk partition and to attach the  partition  to  the
  100.      file system. AAttttaacchh commands have the following format:
  101.  
  102.      AAttttaacchh _p_r_e_f_i_x _d_e_v_i_c_e _g_r_o_u_p _s_c_o_p_e _a_c_c_e_s_s
  103.  
  104.      _P_r_e_f_i_x is the prefix under which to mount the partition.
  105.  
  106.      The _d_e_v_i_c_e is the device on which  to  run  fscheck  and  to
  107.      attach.
  108.  
  109.      The _g_r_o_u_p parameter is used to determine the parallelism  in
  110.      checking  the disks. FFsscchheecckk is a very IO constrained appli-
  111.      cation. Most of the execution time is spent waiting for  the
  112.      disk.  If  the system has more than one disk the overall run
  113.      time of ffssaattttaacchh can  be  decreased  by  checking  different
  114.      disks  at the same time.  _F_s_a_t_t_a_c_h will run jobs in parallel
  115.      if possible.  Any partitions that  are  in  the  same  group
  116.      will  NOT  be  checked  in  parallel.   A  group name is any
  117.      sequence of characters and is  case  sensitive.   The  group
  118.      name  "root"  has  special  significance.  It is used as the
  119.      group of the root  partition.   This  partition  is  checked
  120.      before  all  other  partitions,  and  the server may have to
  121.      reboot if an error is found in this partition.
  122.  
  123.      The _s_c_o_p_e can be either local  or  export.  Partitions  with
  124.      local scope are attached only for the local machine, whereas
  125.      partitions with export scope are attached and exported under
  126.      the given prefix.  The prefix corresponding to the root par-
  127.      tition (usually /bootTmp) is attached during system boot and
  128.  
  129.  
  130.  
  131. Sprite v.1.0       Printed:  January 23, 1991                   2
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138. FSATTACH                  User Commands                  FSATTACH
  139.  
  140.  
  141.  
  142.      is not reattached by ffssaattttaacchh.  For this partition the scope
  143.      parameter does not have any effect.
  144.  
  145.      The _a_c_c_e_s_s is used to set the access permissions of the pre-
  146.      fix.  If  the access is "r" then the prefix is read only. If
  147.      the access is "rw" then the prefix is can be both  read  and
  148.      written.   The  access parameter has no effect if the parti-
  149.      tion is the root partition.
  150.  
  151.      The EExxppoorrtt command is used to export a prefix under  a  dif-
  152.      ferent name.  EExxppoorrtt commands have the following format:
  153.  
  154.      EExxppoorrtt _p_r_e_f_i_x _l_o_c_a_l_P_a_t_h
  155.  
  156.      _P_r_e_f_i_x is the name of the prefix to be exported.
  157.  
  158.      _L_o_c_a_l_P_a_t_h is the name of a path that is to  be  exported  as
  159.      _p_r_e_f_i_x.
  160.  
  161.      All other non-comment lines are  interpreted  as  containing
  162.      arguments to ffsscchheecckk.  The format of these lines is:
  163.  
  164.      _d_e_v_i_c_e_N_a_m_e [_a_r_g_u_m_e_n_t_s]
  165.  
  166.      _D_e_v_i_c_e_N_a_m_e is the name of the device for which ffsscchheecckk is to
  167.      use  the  _a_r_g_u_m_e_n_t_s. A device name of aallll will cause ffsscchheecckk
  168.      to use the arguments for all devices. Any  number  of  argu-
  169.      ments  can  follow the device name, as long as they fit on a
  170.      single line. The same device name can appear on  any  number
  171.      of lines.
  172.  
  173.      The following is a sample mount table. The root partition is
  174.      /_d_e_v/_r_s_d_0_a  and  it is exported under the prefix /_t_1. /_t_2 is
  175.      another small partition on the same disk. /_b is a large par-
  176.      tition  on  the disk, and /_a is a large partition that is an
  177.      entire second disk.
  178.  
  179.           #<Command>      <Prefix>        <Device/Path> <Group>   <Scope>       <Access>
  180.  
  181.           Attach          /t1           /dev/rsd0a     root     export          rw
  182.           Attach          /t2             /dev/rsd0b      A       export          rw
  183.           Attach          /b              /dev/rsd0g      A       export          rw
  184.           Attach          /a              /dev/rsd1c      B       export          rw
  185.  
  186.           Export         /foo      /t2
  187.  
  188.           #<Device>       <Arguments to fscheck>
  189.  
  190.           all             -readBlock 10
  191.           /dev/rsd0b      -outputFile foo
  192.  
  193.  
  194.  
  195.  
  196.  
  197. Sprite v.1.0       Printed:  January 23, 1991                   3
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204. FSATTACH                  User Commands                  FSATTACH
  205.  
  206.  
  207.  
  208. RREETTUURRNN CCOODDEESS
  209.      FFssaattttaacchh returns one of the following codes upon exit.
  210.  
  211.      0    No error.
  212.  
  213.      1    An error was found in the root  partition.  Reboot  the
  214.           system. See ffsscchheecckk for details.
  215.  
  216.      2    A hard error occurred. There was some problem in either
  217.           ffssaattttaacchh,  ffsscchheecckk,  or  pprreeffiixx that prevented ffssaattttaacchh
  218.           from completing normally.
  219.  
  220.      3    FFsscchheecckk returned a soft error indication.  See  ffsscchheecckk
  221.           for details.
  222.  
  223.      4    An error was found  in  the  root  partition,  but  the
  224.           number of consecutive times that ffsscchheecckk was run and an
  225.           error found exceeds the limit.
  226.  
  227. FFIILLEESS
  228.           /boot/cmds/fscheck            command to check disks
  229.           /hosts/$HOST/*.fsc            output from fscheck
  230.           /bootTmp/.fscheck.out              temporary output from fscheck
  231.  
  232. KKEEYYWWOORRDDSS
  233.      fsattach, fscheck, prefix, mount,  disk,  partition,  crash,
  234.      attach, boot
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263. Sprite v.1.0       Printed:  January 23, 1991                   4
  264.  
  265.  
  266.  
  267.